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600 

Class Hierarchy 

doss jovo.lang.Object 

interface com.ibm.jtcApplicationMediator (extends conn.ibm.jtc.JTC) 

doss com.ibna.jtc.ApplicQtionMediotorlmpI (innplements com.ibnn.jtc.ApplicotionMediotor, 

com.ibnri.jtc.ViewListener, conn.ibm.jtc.RequestResponseListener) 

interface cam.ibm.jtc. Destination (extends com.ibnn.jtc.JTC) 

doss conn.ibm.jtc.DestinotionlmpI (implennents conn.ibm.jtc.Destination) 

doss javo.util.EventObject (innplennents javo.io.Seriolizoble) 

doss copn.ibm.jtc.PlacementEvent (innplennents javo.io.Seriolizoble) 

doss conn.ibm.jtc.RequestEvent (innplennents jova.io.Seriaiizoble) 

doss conn.ibnn.jtc.TopEvent (implennents jovo.io.Seriolizable) 

doss cann.ibnn.jtc.ViewEvent (innplennents javQ.io.Serioiizoble) 
doss cann.ibnn.jtc.Factary (innplennents java.io.Seriolizable) 
interfoce conn.ibnn.jtc.JTC (extends jovo.ia.Seriolizoble) 
interfoce conn.ibnn.jtc.PiocennentListener - 
interfoce conn.ibnn.jtc.RequestListener 

interfoce cann.ibnn.jtc.RequestResponseListener ' 

doss jovo.lang.Throwoble (innplennents jovo.io.Seriolizable) 
doss jovo.lang, Exception 

doss conn.ibnn.jtc.RequestException (innplennents jovo.io.Seriolizoble) 
doss conn.ibnn.jtc.VolidotionRuleException (innplennents javo.io.Seriolizoble) 

interfoce conn.ibnn.jtc.TopListener 

doss conn.ibnn.jtc.Tronsporter (innplennents conn.ibnn.jtc.RequestListener. conn.ibnn.jtc.JTC) 
doss cann.ibnn.jtc.VolidotionRule (innplennents jovo.io.Seriolizable) 
interfoce conn.ibnn.jtc.ViewController (extends conn.ibnn.jtc.JTC) 
interfoce conn.ibnn.jtc.ViewListener 
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public static final String_copyright 


(c) International Business Machines Inc.. 
1997 1998 1999. All rights reserved. 
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public static final int NONE 




COMPONENT 
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public static final int FOCUS 
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FIG. 12D T 

A* 

* Given o list of class nomes, opply each validation rule of the classes 

* to input string and return the formatted result. 
♦ 

* ©return the viewoble formotted string. • 

* ©porom ciossNames o comma -separated fully qualified list of concrete AbstroctRule^ dosses. 

* ©porom input the input string to apply edit rules to. 

* ©exception VoiidotonRuleException if there wos on error in applying the edits. 
♦/ 

public static String applyEdits(String classNames, String input) throws VoiidationRuleException | 
int commalndex = -1; 
int curlndex = 0; 
do I 

commoindex=classNomes.indexOf('/, curlndex); 
if (commolndex == -1) \ 

commalndex = clossNames.lengthQ; 

String clossNome = classNames,substring{curlndex, commalndex).trim(); 
try I 

ValidationRule rule = (ValidationRule) Factory.newlnstance(clossName); 

input = rule.edit(input); 
( catch (VolidotionRuleException re) | 

throw re; 
j catch (Exception e) | 

throw new VolidationRuleExceplion("Rule class + clossNome + not found."); 

I 

curlndex = commolndex + 1; 
I while (curlndex < clossNames.length()); 
return input; 

I 
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ApplicotionMediotor ImpI.exitQ : AUS8- 1999-0694 
A» 

* Exit the ApplicotionMediotor by exiting oil ollocoted ViewControllers 

* and ApplicotionMediotors. All doto is set to null, ond lists ore 

* destroyed. An 'exited' ApplicotionMediotor connot be used again. * 

* If this method is overriden in o subcloss, be sure to invoke 

* super.exit(); 

**/ 

public void exit() | 

synchronized (this) | 

/* Used for style 1 event dispotching. Leove this code commented. »/ 
//if (this.eventThreod !=null) | 

'J, ^ 

// eventThreod.stop (); 

// I cotch (Exception e) | 

//I 

/♦ Used for style 2 event dispotching. Leave this code commented. »/ 
for (int i = 0; i < runningThreads.size(); i++) { 

((ApplicotionMediotorThreod) runningThreods.elementAt (i)) .stop(); 

runningThreods.removeAIIEIementsO; 
viewListeners.removeAIIEIements(); 
try I 

for (int i = 0; i < viewControllers.size(); i++) | 

ffViewController^ viewControllers.elementAt(i)) .setEnobled(folse); 
((viewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < opplicotionMediotors.size(); i++) | 

(fApplicotionMediotorl opplicctionMediotors.elementAtn)) .setEnabled(false); 
((ApplicotionMediotor) applicationMediators.elementAt(i)) .exit(); 

I cotch (Exception noProblem) \ 

viewControlIers = null; 
opplicotionMediotors = null; 
runningThreods = null; 
runningThreods = null; 
doto = null; 

^ FIG. 17F 
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ApplicotionMediotorlmDi.cleorn : AUS8- 1999-0694 
A* 

* Cleor the ApplicotionMediotor by cleoring oil allocoted ViewControllers 

* ond ApplicotionMediotors. All data is set to null, but lists ore 

* not destroyed. A 'cleored' ApplicotionMediotor con be used ogoin. 

* If this methed is overriden in o subclass, be sure to invoke 

* super.cleor(); 

*/ 

public void clear() j 

synchronized (this) | 

/* Used for style 1 event dispotching. Leove this code commented. */ 
//if (this.eventthreod != null) | 

// eventThreod.stop (); 

// \ catch (Exception e) j 

//I 

/* Used for style 2 event dispatching. Leove this code commented. */ 
for (int i = 0; i < runningThreads,size(); i++) { 

((AppiicotionMediotorThread) runningThreods.elementAt (i)) .stop(): 

runningThreads.removeAIIEIements(); 
try j 

for (int i = 0; i < viewControllers.size(); i++) \ 

ffViewController) viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < applicationMediotors.size(): i++) | 

ffApplicationMediotorl applicationMediolors.elementAlfi)^ .setEnabled(false); 
((ApplicotionMediotor) opplicotionMediators.elementAt(i)) .cleor(); 

I cotch (Exception noReolProblem) | 

ViewControllers = null; 
oppIicotionMediotors = null; 
doto = null; 

viewListeners.removeAIIEIements(); 

' FIG. 1 7G 
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* Initolize the ApplicotionMediotor using the listeners of on 

* existing ApplicotionMediotor. 

public void init(ApplicationMediator opplicctionMediotor) { 

if (opplicotionMediotor instonceof ApplicotionMediotorlmpI) | 

AppiicotionMediotorlmpI a = (ApplicotionMediatorimpl) opplicotionMediotor; 
requestListeners = (Vector) o.requestListeners.clone(): 
plocennentListeners = (Vector) o.placementListeners.clone(); 
topListeners = (Vector) a.topListeners.clone(); 
oddViewListener(a); 



initO; 



/ 



FIG. 1 7H 
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* When new data arrives allow the ViewControllers 

* and ApplicationControIlers to be refreshed also. 

*/ 

public void refresh(Object data) | 
this.doto = data; 
try } 

synchronized (viewControllers) j 

for (int j = 0; j < viewControllers.size(); j++) \ 

((ViewController) viewControllers.elenrientAt(j)). 
refresh(data); 

I catch (Exception noRealProblem) | 
try \ 

synchronized (opplicotionMediotors) \ 

for (int j = 0; j < applicationMediators.size(); j++) | 
((ApplicotionMediator) appiicotionMediators. 
elementAt(j)).refresh(data): 

I catch (Exception noReolProblem) { 



FIG. 1 71 
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♦ A ViewEvent is delivered. Process it using Threoding style 1 or 2. In 

* the end, the processViewEvent will be colled on the subcloss. 

*/ . 
public void viewEventPerfornned (ViewEvent e) \ 

/* Used for style 2 event dispotching, start on inner doss thread */ 
ApplicotionMediotorThreod t = new ApplicotionMediotorThreod (e); 
runningThreods.oddElennent (t); 
t.stort (); 

/* Used for style 1 event dispotching. Leove this code comnnented. */ 

//ViewEvent soved = saveViewEvent(e}; 

//if (eventThreod == null | | !eventThread.isAlive()) | 

// finished = folse; 

// eventThreod = new Thread(this); 

// eventThreod.stort (); 

//synchronized (this) | 
// notifyO: 

FIG. 17J 



1714 

* This nnethod is used in style 1 threading. Renonne this to run () 

* ond unconnment the code os described in the class javodoc. 

v 

public final void run2 () | 

/* Used for style 1 event dispatching. Leove this code commented. */ 

/* 

while (true) } 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) J 

hondleViewEvent (event); 
\ else \ 

woitForEvent (); 

if (finished) { 

// something went wrong with the threod so hose this loop 
break; 

FIG. 1 7K 
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♦ Private class to hondle executions of ViewEvents () on another threod. 

**/ 

privote doss ApplicotionMediotorThreod extends Thread j 

A* 

* The current event 

**/ 

private ViewEvent event; 
A* 

* Creote on ApplicotionMediotorThreod to process the ViewEvent 

public ApplicationMediatorThread(ViewEvent event) | 
super (); 

this.event = event; 

* Just coll the hondleViewEvent method thot the subcloss will override 

public void run () | 

processViewEvent (event); 

' FIG. 1 7L 



1714 

* Save the current ViewEvent on o Q 

V 

privote finol ViewEvent soveViewEvent (ViewEvent e) | 

/* Used for style 1 event dispatching. Leave this code comnnented. */ 
//return viewEventQueue,odd(e); 
return null; 

I 

A* 

* Method: return the first view event saved. Used by the Q'ing systenn. 

*/ 

private ViewEvent getViewEvent () j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

* FIG. 17M 
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Tronsporter.requestEventPerformed(RequestEvent) :AUS8- 1 999-0693 

* Submit 0 synchronous request. For each Destination that is listening for 

* the current fonnily of RequestEvents (the major code), send the RequestEvent 

* to the Destinotion for processing. If there is a problem, throw 

* 0 RequestException. Continue processing the RequestEvent as long 

* as a RequestException is not thrown by o Destination and the RequestEvent 

* is not consumed. 

* <p> 

* If tagging is enabled, then append a status tog to the RequestEvent. 
♦<p> 

* Destinations are processed in the following FIFO order: 

* 1- All using (priority). 

* 2- All using a major code. 

* 3- All using 
Kp> 

* ©exception RequestException if the Request can't be submitted 

V 

public void requestEventPerformed(RequestEvent request) throws RequestException | 
if (lenobled) j 

throw new RequestException("Transporter disabled"); 

/* Try to tag the request */ X 
if (tagging) ^2606 
request.setStatus(request.getStatus() + "[Transporter]"); " ' 

/* Process PRIORITY, major and then WILDCARD destinations */ 
processDestinotionsf request. getDestinotionsfPRIORITY)); 
processDestinationsi request. getDestinations(request.getMojor())); 
processDestinations(request. getDestinations(WlLDCARD)); 



FIG. 26 F 



I 



* Submit on asynchronous request. See the synchronous 

* requestEventPerformed for more information. 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException | 
if (lenobled) j 

throw new RequestException("Transporter disabled"); 

if (tagging) 

request.setStatus(request.getStatus() + 

"[Transporter osync.]"); "*^2608 

//start an inner class thread 

TronsporterThreod t = new TransporterThread(request, caller); 

runninqThreads.put(request, t); 

t.startQ; 

' FIG. 26G 
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2610 

TronsporterJronsporterThreod :AUS8- 1 999-0693 

A* 

* Private class to handle executions of submits() on onother 
thread. 

private class TronsporterThread extends Thread j 

/- 

» The current request 

A* 

private RequestEvent request; 

A* 

* The caller of submit that we will coll bock 

-/ 

private RequestResponseListener caller; 



A* 

* Create o transporter threod 

public TronsporterThreGd(RequestEvent request, 
RequestResponseListener caller) j 
superQ; 

this.request = request; 
this.caller = caller; 

* Just coll the synchronous version of 
requestEventPerfornnedO 

*»/ 

public void run() j 
try I 

requestEventPerformed(request); 

caller. requestResponse(request); 
} catch (RequestException yikes); \ 

caller.requestException(yikes); 
j finally \ 

runningThreads.rennove(request); 

FIG. 26H 
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RemoteDestinotion.requestEventPerformed(RequestEvent) :AUS8- 1 999-0704 
/- 

* Process request event. 
♦ 

» <P>PRE: None 

* <P>POST: None 

* ©porom request the RequestEvent object to be processed. 

* ©exception RequestException if there wos on error during the 

* processing of the event. 

V 

public void requestEventPerfornned(RequestEvent request) throws 
RequestException | 
try j 

Method method = null; 
if (session == null) | 

// get home interface. 
Context ctxt = getlnitiolContextQ; 
Object home = ctxt.lookup(request.getMojor() + 



"SessionHome"); 



I 



method = home.getCloss{).getMethod("creote*\ null); 
session = method.invoke(home, null); 



//get method on home object and invoke it. 

method = session.qetClass(),getMethod(request.getMinor(), 

new Class[] }Object.class(); 
request.setData(method.invoke(session, new Object[] 
jrequest.getDotoOl)); 

if (request,getMinor().equals("remove")) { 
session = null; 

\ catch (InvocotionTargetException te) | 

throw new RequestException(te.getTargetException()); 
I catch (Throwoble t) | 

throw new RequestException(t); 

I ' \ 

2806 

FIG. 28D 



Factory 

Voriobles 



Nome 


Declaration 


Description 


.copyright 


public static final String_copyright 


(c) International Business Machines Inc.. 
1997 1998 1999. All rights reserved. 



FIG. 29A 2900 
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View Controller 
C START ) 



Select screen 



Create class 



Override init() method 
reploce with code to 
create, initialize and 
layout graphical 
components 



Override 
refresh() method 



Override 
cleorQ method 



Add view controller 
OS components 

event listener 



Implement 
event listeners 



Use validation 
rules to volidote 
user input 



Create and fire 
ViewEvents 



C END ) 

FIG. 31 



Create Volidotion Rule 
C START ) 



Choose business 
volidotion rule 



Create class 



Override edit() 
method 



I 



Override 
normolizeO method 



•3200 



•3202 



■3204 



■3206 




Validation 

rule 
exception 



( END ) 

FIG. 32 



Creote a ViewEvent 
C START ) 



3210 



Creote interfqce to 
ViewEvent codes 
in opplicotion 



3300 



Create instonce 
of ViewEvent 



I 



Send ViewEvent 
C END ) 

FIG. 33 



■3302 
•3304 
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3400- 
3402- 
3404- 
3406- 

3408- 

3410- 
3412- 



Create 
ApplicotionMediotor 

C START 3 



Choose function 



Creote doss 



I 



Override init() method 



I 



Creote ViewControllers 



I 



Override process 
ViewEventO nnethod 



Create RequestEvents 



Involve refresh 



C END ) 

FIG. 34 



Create RequestEvent 
C START 3 



Create interface 
to contoin strings 
of major and minor 
codes of RequestEvents 



I 



Create instance 
of RequestEvent 



Send event using fire 
RequestEventO method 



( END ) 

FIG. 35 

Create a Destination 
C START ) 



Choose destination 



Creote doss 



Override init() method 



I 



Override 
requestEventPerformedO 
method 



Override 
concelO method 



Override 
finalize() method 



FIG. 36 



■3500 



■3502 



■3504 



■3600 
■3602 
■3604 

-3606 

-3608 
-3610 
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3702- 
3704- 

3706- 
3708- 



Creote TopListener 
C START ) 



Create class that 
contains or is in the top 

frome of opplicotion 
and implements interface 



Create exit() method 



I 



Create lounchQ 
method 



I 



Create message() 
method 



Create title() method 
( END ^ 

FIG. 37 



Create 
PlocennentListener 

( START ) 

Create type ^5800 
of placement 



Create class 
implementing 1^ 3802 
PlocementListener 
interface 

Implement 
placement method "^3804 

( END ) 

FIG. 38 
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Basic Operation of a ViewControllerlmpI 



4000- 

4002- 
4004- 
4006- 

4008- 
4010- 



4012- 



C START ) 



Implement 
the ViewController 
Interfoce 



Implement 
the JTC Interfoce 



Add specific methods 



Create and 
compose the GUI 



Return "yourself" 
in getComponent 



Return permission 
keys, resources and 
properties when osked 



Update permission 
keys, resources and 
properties when asked 



FIG. 40 



Handle internal 
AWT events 



Volidote ond 
format data fields 



Issue ViewEvents for 
sennontic interpretotion 



Return the AWT 
threod immediotely 



Handle refresh colls 
to update the GUI 



Access the doto 




Still \YES 
octive?. 



4026 



•4014 



■4016 



4018 



■4020 



4022 



■4024 



58/119 
AUS990339US3 



C START ) 



4100- 



4104- 

4106- 
4108- 

4110- 



4114- 

4116- 

4118- 
4120- 



ApplicotionMediator 
receives ViewEvent 
from ViewController 




Create PlocementEvent 
with proper mojorCode 



Fire PlocementEvent 



Invoke PlocementListener 



PlocementListener 
receives 
PlocementEvent 




mojorCode = = 
PlocementHTML 

9 

4112 ^ 



Coll toHTMLO on 
ViewController component 



mojorCode == NO 
OtherAlternoteView 



Tronslote View 
components into 
HTML components 



Creote ond place 
OtherAlternoteView 



■4124 



Generote HTML output 



Send HTML output to 
client Browser for disploy 



FIG. 41 
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ViewEvent and ViewListener Usage 

— ► Usage from o ViewController 

public void octionPerformed(ActionEvent e) \ 
if (e.getSourceO == nextButton) | 

ViewEvent ve = new ViewEvent (this); 
ve.setMojor(ViewEvent.NEXT); 
fireViewEvent(ve); //notify 
ViewEvent listener 
return; 



FIG. 42 



Usoge from ViewListener (i.e. ApplicotionMediotor) 
//add myself as a listener 
customerDetailsViewController.addViewListener(this); 

//later, we ore called bock on this method to hondle the 
ViewEvent 

processViewEvent (ViewEvent event) | 
//do something 
switch (event.getMojorO) \ 
case ViewEvent. NEXT: //... 
break; 

cose ViewEvent.OK: //... 
break; 



FIG. 43 
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ValidationRules Usage 

Example Chaining 
//each rule 

String range = "com.xyz.jtc.RangeChecker"; 
String money = "com.xyz.jtcAccountMoney"; 

//build the chain of rules 
String[] rules = jronge, moneyj; 

//get the value to volidote 
String value = textField.getText(); 

try) ^ ^ 

value = applyEdits(rules. input); 

catch (VolidotionRuleException ouch) j 

,//... 

//the value is validated and formatted, redisplay 
textField.setText(value); 

FIG. 47 

ViewControilerBoselmpI 

For example: 

♦ inheritance 

public class ViewControilerBoselmpI extends JPonel | 
public Component getComponentQ | 
return this; 

FIG. 48 

♦ delegation 

public class ViewControilerBoselmpI implements ViewController 

XYZ xyz = new XYZ(); 

public jovo.owt.Component getComponentQ { 
return xyz; 

public void setEnabied(boolean e) | 
xyz.setEnobled(e); 

public void setVisible(boolean v) | 
xyz.setVisible(v); 

' FIG. 49 
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C START ) 



5200- 



5202- 



5204- 



5206- 



5208- 



5210- 



5214- 



5216- 



5218- 



5220- 



5222 



Implement 
ApplicotionMediotor Interfoce 



Implement JTC Interface 



Add 

ApplicotionMediotorlmpI methods 



Create ViewControllers 
using initViewControllers 



Use InitApplicationMediator 

to create other 
ApplicationMediotors 
as necessary 



Listen for ViewEvents 
and RequestEvents 




Request PlocementListener 

to put onother 
ViewController on screen 



Hove TopListener do desktop 
operotions os oppropriote 



Fire oppropriote 
requestEvents to servers 



Send refresh colls to 
ViewControllers and 
ApplicationMediotors 



Return all JTC 
objects ollocoted 



FIG. 52 

Design Steps for 
on ApplicotionMediotor 
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5300 



Placement runtime 



c 



< 



"click" 

1 £ 



AWTEvent 



33 



c 



VolidotionRules 



) 



ViewController 



0 I o t> o t> I [fr] 



5302 
5308 



J 



VolidotionRuleException 



ViewEvent ^ 



5304 



PlocementListener 



L/^ (data)' — ^ 



5306 



ApplicotionMediator 



0 I c> o > t> I (&] 



□ 



PlocementEvent 



5310- 



< 



> 



extends 



subclass 



> 



3 



FIG. 53 



Placement example 

Usage from ApplicotionMediator 
//in on ApplicotionMediotor 
int major = PlocementEvent.ADD; 
Component component = 
customerDetoilsViewController.getComponentO; 
PlocementEvent e = new PlacementEvent(this. component, major); 
firePlocementEvent(e); 

FIG. 54 



Usage from PlocementListener 

public class MyProgrom implements PlocementListener | 

public void plocementEventPerformed(PlacementEvent e) | 
//decide based on source type 
switch (e.getMojorO) \ 

cose PlocementEvent.ADD: 

if (e.getSourceQ instonceof PreferencesAmJ 
panell.oddf Center", e.getComponent()); 

else pQnel2.add("A", e.getComponent()); 
break; 

cose PlocementEvent.REMOVE: 
//do something else 

break; 

//etc. 



FIG. 55 
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5600- 



5602- 



5604- 



5606- 



C START ) 



ViewControlIers respond 
to getComponentO 



I 



ApplicotionMediotors control 
ordering of ViewControlIers 



ApplicotionMediotors 
fire PlocennentEvents 



PlocennentListeners select the 
proper implementotion and place 
the Component on the screen 



FIG. 56 

Design Steps for 
0 PlocementEvent 



( END ) 



5700 



TopListener runtinne 



"click" 



c 



VolidotionRules 



<^ AWTEvenT^ 



ViewController 



VolidotionRuleException 



1 



PlocennentListener 



0 I t> > o t> I [&1 



3 



< ^ ViewEvent ^ 

c 




5706 



DATA 



Applicoti onMediotor ^ 



K 



PlocementEvent 





— 










r TopListener 


Urn 

® 

sst 




s 

5702 








t 1 III i0~ 





<(^TopEvent^^ 



< ^ RequestEvent ^ 



5704 [DATA 



^e xtends 




RequestListener 



<^ subcloss ^ 



lounch 



exit 



F/G. 57 



desktop 



browser 



reconfigure 
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Transporter 

This class implements the JTC end RequestEventListener interfaces 
Its primary function is to mop RequestEvents to Destinations. 
♦ Typically ApplicationMediators fire RequestEvents and Destinations process 
them 

Add a Transporter to an AppiicotionMediator to listen for RequestEvents 



Transporter t = new Transporter(); 
AppiicotionMediator am = new ApplicationMediator(); 
am.addRequestListener(t); 

The AppiicotionMediator will fire RequestEvents 

RequestEvent r = new RequestEvent(source, major, minor, data); 
try I 

fireRequestEvent(r); 
catch (RequestException yikes) \\ 

FIG. 67 
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Destination 

RequestEvents ore identified by 

♦ mojor code - represents a fomily of Requests 

♦ minor code - represents a specific Request 

Destinations are added to the Transporter as DestinotionListeners 

specifing a nDojor code for RequestEvents they ore interested in receiving 
The destination is called when the nnajor code of the RequestEvent 
nnotches the destination mojor code 



EJBDestinotion d = new EJBDestinationQ; 
Transporter t = new Transporter(); 
String mojor = "Loons"; 
t.oddDestinQtionListener(mojor, d); 



Multiple Destinotions con listen for the same RequestEvent major code 
♦processed FIFO/FESP (first in first out, first exception stop forwarding) 
♦ results of one Destination con be passed to the next Destination 

FIG. 69 



Destinations and nnajor codes 

Speciol major codes 

♦ wildcord 

■ major code indicates the Destination is interested in all and any RequestEvents 

■ processed after specific major codes hove been motched. 

♦ priority 

■ major code indicates the Destinotion is interested in all requests and should be given 
priority. 

■ processing performed before specific mojor codes ond wildcards 
For example 

Transporter t = new Transporter(); 
t.oddDestinotionListener f"*", new WildDestinotion ()); 
t.oddDestinotionListener ("Loons", new EJBDestinationQ); 
t.oddDestinotionListener ("!", new PriorityDestinotionQ); 

//later 

RequestEvent r = new RequestEvent(this, "Loons". " ", null); 
try I 

fireRequestEvent(r); 
catch (Request Exception yikes) || 

♦The RequestEvent "r" will be sent to PriorityDestination 1st. EJBDestinotion 2nd, 
and WildDestinotion() 3rd, assuming no RequestExceptions ore thrown. 

FIG. 70 
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( START ) 



Coll getJTCs 
and get Vector 
of JTC objects 



7500 




7506- 



Use entry(i) 




NO 7528 
^ / 

Listen 
for events 
ond debug, 
log. troce, 
sinnulote 



( RETURN ) 



7524 




Add OS 
RequestListner 



hookAWts with 
Connponent 



7522 



Add OS 
RequestListener 



hookAWts with 
Component 



7518 



■7510 



7512 



I 



FIG. 75 



76/119 
AUS990339US3 



7600^ 


A 
















7602^ Al 


A2 


A3 ^7606 



7608- 



7604 



All 




A12 




A31 




A32 






\ 





■7614 



7610 

FIG. 



7612 

76 



hookAWTs with 
Component XYZ 




7702- 



7706- 



Get list of 
Components in 
Contoiner XYZ 




Use 
Conriponent(i) 



Hook 
the Component 
XYZ 



■7714 



7708 




C RETURN ) 
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Doto Objects 

s/ The ApplicotionMediotorlmpI will forword the refresh (defoult) 

Lfor each: ApplicationMediotor -> refresh(data) 
for each: ViewController -> refresh(data); 

FIG. 79 



yj The ViewController will update the GUI 

public void refresh(Object data) j 
//this exomple uses o keyVolue poir doto model 

if (doto == null) return; 
else refresh((KeyVolue) doto); 

public void refresh (KeyVolue doto) { 

nomeField.setText(doto.get("CustomerNome")); 
idField.setText(data.getC'Customerld'O); 
repoint(); //if necessory 

L FIG. 80 



Data Objects 

s/Wo^ con we odd o new doto model (i.e. reol objects)? 

public void refresh(Object doto) | 
if (data == null) return; 
else if (doto instonceof Vector) | 
refresh((Vector) data); 

else if (data instonceof KeyVolue) | 
refresh((KeyVolue) doto); 

' FIG. 81 



public void refresh(Vector doto) j 
//I know what they ore 
Customer c = (Customer) dota.elementAt(O); 
ID id = (ID) doto.elementAtfl); 
nQmeField.setText(c.getNome()); 
idField.setText(id.toString()); 
repoint(); //if necessary 

' FIG. 82 
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More on data 



8304 



ApplicotionMediotor ^ 



property 
change 




8302 



async streoming 



8300 



ViewController 



1. Named methods 
public double get CustomerName() 

2. Implicit data model ond ViewEvent 
ve.setDotoC'Mr. Chips"): 
fireViewEvent(ve); 

3. Explicit data model and ViewEvent 
doto.putC'LASTNAME". 'Xhips"); 
ve.setData(data); 
fireViewEvent(ve); 

4. Property Change events 
data.putC'SOLUTION", "JTC"); 
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( END ) 
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package com.ibm.jtcx.serialization; 

import javc.io.Externalizoble; 
import jovo.io.lOException; 
import jovo.io.Objectlnput; 
import jovQ.io.ObjectOutput; 
A* 

* Defoult type comment. 
* 

* <P>INVARIANT: 
V 

public class BoseDoto implements Externolizable } 
privote Object[] doto = null; 

A* 

* BoseDoto constructor comment. 

*/ 

public BaseDotaQ | 
this(O); 

A* 

» BoseDoto constructor comment. 

* ©porom dotoArroy jovo.long.Objectf] 
*/ 

public BaseDQta(int count) | 
super(); 

setDoto(new Object[count]); 

A* 

* Defoult method comment. 

* <P>PRE: 

* <P>POST: 
* 

» ©return Parameter not modified 

* ©return jova.lang.Object[] 
*/ 

public final Object[], getDotoO | 
return data; 

I 

FIG. 107 A 
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10700 

A* 

* Default method comment. 
« 

* <P>PRE: 

* <P>POST: 

* 

* ©return Porometer not modified 

* ©return javc.lang.Object 

* ©parom index int 

V 

public find Object getDotoCint index) | 
Object retVol = null; 

if ((data != null) && (index < doto.length)) | 
retVal = data[index]; 

return retVol; 

* Default method comment. 
* 

» <P>PRE: 

* <P>POST: 

* ©return Parameter not modified 

* ©param in Objectlnput 
*/ 

public void readExternal(Objectlnput in) 

throws ClossNotFoundException, lOException | 

setData((Object[])in.readObject()); 

/** 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 
* 

* ©return Parameter not modified 

* ©param dotoArroy java.lang.Object[] 

»/ 

public final void setData(Object[] dotoArroy) \ 
data = dotoArroy; 



FIG. 107B 



95/119 
AUS990339US3 



10700 



A* 

* Defoult method comment. 
« 

* <P>PRE: 

* <P>POST: 

* 

* ©return Porometer not nnodified 

* ©porom index int 

* ©parom datoElement jovo.long.Object 

•/ 

public final void setDoto(int index, object dotoElennent) { 
if ((dote != null) && (index < dota.length)) \ 
dotofindex] = dotoElennent; 



* Defoult nnethod connnnent. 
* 

* <P>PRE: 

* <P>POST: 

» 

* ©return Parameter not modified 

* ©porom out ObjectOutput 
*/ 

public void writeExternal(ObjectOutput out) throws lOException 
out.writeObject(getData()); 



FIG. 107C 
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pockoge com.ibm.jtcx.seriolizotion; 

import java.io.Externolizable; 
import javQ.io.lOException; 
import jovajo.Objectlnput; 
import jovo.io.ObjectOutput; 
import jovo.moth.BigDecimol; 
import jova.math.Biglnteger; 
import javo.util.Dote; 
import jovo.util.Enumeration; 
import javo.util.GregorionColendor; 
import java.util.Hoshtable; 
import jovo.util.SimpleTimeZone; 
import jovo.util.TimeZone; 
import jovo.util.Vector; 

A* 

* Bose class of doto objects thot require small seriolization. The 

* ottributes of the data object ore stored in on array ond the elements 

* of the array ore written individuolly. 
* 

» <P>INVAR1ANT: 
*/ 

public class BaseDatoS extends BaseData implements Externalizable } 

A* 

* Default constructor. 

V 

public BoseDotoSO | 
superQ; 

* Creates a new <code>BaseDataS</code> object with o data array of 

* size <code>count</code>. 
* 

* ©parom count the size of the data array containing the attributes 

V 

public BaseDataS(int count) { 
super(count); 

FIG. 1 08 A 



97/119 
AUS990339US3 



* Reods the arroy of doto elements from the streom. The responsibility 
» of reeding the individuol element is left to the 

* <code>BaseSeriolizer</code> vio <code>readObject()<code>. 
* 

* ©porom in the input streom thot contoins the seriolized object 
» ©exception ClossNotFoundException thrown if 

» <code>BoseSeriQlizer</code> foils to read the object from the streom 

* ©exception lOException thrown if 

* <code>BoseSerioli2er</code> foils to reod the object from the streom 

* ©see BoseSeriolizerfreodObject 
*/ 

public void reodExternol(Objectlnput in) 

throws ClossNotFoundException. lOException j 

int size = in.reodShortQ; 

if (size -1) I 

setDoto(null); 

I else I 

Object[] orroy = new Object[size]; 

for (int i = 0; i < size; i++) | 

array[i] = BaseSerializer.getlnstance().readObject(in); 



setData(arroy); 



4e* 



* Writes the orroy of doto elements. The responsibility of writing the 

* doto elements is left to <code>BoseSeriQlizer</code> via 

* <code>writeObject()</code>. 
* 

* ©porom out the output streom to which the data elements will be 

* written 

V 

public void writeExternal(ObjectOutput out) throws lOException \ 
Object[] array = getData(); 

if (orroy == null) j 

out.writeShort(-l); 

I else I 

out.writeShort(orroy.length); 

for (int i = 0; i < orroy.length; i++) | 

BaseSerializer.getlnstance().writeObject(out, array[i]); 

i ^ 

10800 

FIG. 1 08 B 
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ApplicotionMediator(i) 



ApplicotionMediGtor(i).refresh 
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For each 
ViewController(i) 



ViewController(i).refresh 
(Object doto) 




( RETURN ) 
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Encoding ApplicationMediators 

SI: (VE.source==vc1 && VE.major==A && VE.minor==B) => 
(RE.mQjor=C RE.minor=D RE.doto=VE.dato RE.fireS) 

if event source is vcl with A.B os major/minor then 

fire sync request with C.D mojor/minor and use doto from event) 

S2: VE.source==vc4 && VE.nnojor==5) ==> (TE.major=3 TE.fire) 
if event source is vc4 with 5 os mojor then 

fire top event with major 3 . 

S3: (Refresh) = = > (VC.i.refresh(Refresh.data)) 

if refresh(data) occurs, then refresh oil view controllers with the 
some data, but not the other application mediotors . 

S4: (VE.source==vcA) ==> (RE.major="set"RE.fireA) && 

(PE.major=PE.ADD PE.source=vcB PE.fire) && (VC.vcB.refresH(RE.doto)) 
if event source is vcA, then fire osync request, then fire placement 
event, then refresh the newly placed view controller with the doto 
returned with the request 

FIG. 1 02 
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11000 

int scale = in.reodShort(); 
int size = in.reodShort(); 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

Biglnteger temp = new Biglnteger(bytes); 
return new BigDecimol(tennp, scale); 

public void writeObject(ObjectOutput out, Object element) throws lOExceptipn | 
BigDecimol bigD = (BigDecimol)element; 

int scale = biqD.scale(); 
bigD.setScale(O); 

byte[] bytes = biQD.toBiglnteger().toByteArray(); . 
bigD.setScole(scale}; 

out.writeShortfscale); 

out.writeShort(bytes.length); 

out.write(bytes); 



class BiglntegerSerializer implements SerializerIF | 

public Object reGdObject(ObjectInput in) throws ClossNotFoundException. lOException 

int size = in.readShortQ; 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
byte[] bytes = ((Biglnteger)element).toByteArray(); 

out,writeShort(bytes. length); 
out.write(bytes); 



class BooleonSeriolizer implements SerializerIF \ 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException 

int value = in.readByte{); 

return (value == 1) ? Booleon.TRUE: Booleon.FALSE; 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writeByte(((Boolean)element).booleanValue() ? 1 : 0); 



FIG. 1 1 0B 
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11000 



doss ByteSeriolizer implements SeriolizerIF | 

public Object reodObject(Ob]ecl Input in) throws ClossNotFoundException, lOException | 
byte value = in.readByte(); 



doss ChorocterSeriolizer implements SeriolizerIF | 

public Object reodObject(Object Input in) throws ClossNotFoundException, lOException | 
chor volue = in.reodChorQ; 

return new Chorocter(volue); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
out.writeChor(((Charocter)element).chQrValue()); 

I ' 

cioss DoteSeriolizer implements SeriolizerIF { 

public Object reod0bject(0bjectlnput in) throws ClossNotFoundException lOException | 
long volue = in.reodLongQ; 

return new Date(volue); 
public void writeObject(ObjectOutput out, Object element) throws lOException \ 



doss DoubleSeriolizer implements SeriolizerIF | 

public Object reod0bject(0bjectlnput in) throws ClossNotFoundException, lOException { 
double volue = in.reodDouble(); 

return new Double(volue); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writeDoubIe(((Double)element).doubleVolue()); 



return new Byte(volue); 




element) throws 'lOException | 




FIG. 1 1 0C 
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class FloatSeriolizer implements SeriolizerlF j 

public Object read0bjecl(0bjectlnput in) throws CiossNotFoundException. lOException | 
floot volue = in.readFlootQ; 

return new Float(value); 

public void writeObject(ObiectOutput out, Object element) throws lOException j 
out.writeFloot(((Floot)element).flootVolue()); 

doss GregorionColendorSeriolizer implements SeriolizerlF { 

public Object reodObject(Objectlnput in) throws CiossNotFoundException. lOException | 
long time = in.reodLonqQ; 
Dote dote = new Date(time); 
SeriolizerlF seriolizer = BoseSeriolizer.getlnstanceQ; 
TimeZone tz - (TimeZone)seriolizer.reodObject(in); . " 

GregorionColender gColender = new GregorianCalendar(tz); 
gColendor.setTime(dote); 

return qCoiendor; , ■ 

I 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
GregorionColendor temp = (GregorionColendor)element; 

Dote dote = temp.getTime(); 
TimeZone tz = temp.getTimeZone(); 

out.writeLong(dote.getTime()); 

SeriolizerlF seriolizer = BoseSeriolizer.getlnstonce(); 

seriolizer.writeObject(out. tz); 

cioss IntegerSeriolizer implements SeriolizerlF j 

public Object reodObject(Objectlnput in) throws CiossNotFoundException, lOException j 
int value = in.reodlntQ; 

return new Integer(volue); 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
out.writelnt(((lnteger)element).intVolue()); 

class LongSeriolizer implements SeriolizerlF j 

public Object reodObject(Objectlnput in) throws CiossNotFoundException, lOException j 

FIG. 1 1 0D 
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long value = in.reodLong(); 
return new Long(value); 

public void writeObject(ObjectOutput out. Object elennent) throws lOException } 
out.writeLong(((Long)element).longVolue()); 

class ObjectArraySeriolizer innplennents SeriolizerlF j 

public Object reodObject(Objectlnput in) throws ClassNotFoundException. lOException { 
int size = in.readShortQ; 

Object[] orroy = new Object[size]; 
for (int i = 0; i < size; i++) | 

SeriolizerlF seriolizer = BaseSerializer.getlnstonce(): 

array[i] = serializer.readObject(in); 

return array; 

public void writeObject(ObjectOutput out, Object element) throws lOException } 
Object[] array = (Object[])elennent; 

out.writeShort(orrayJength); 

for (int i = 0; i < array length. i++) \ 

SeriolizerlF seriolizer = BoseSerializer.getlnstance(); 

serializer.writeObject(out, orray[i]; 



I 



doss ObjectSeriolizer innplements SeriolizerlF I 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException | 
return in.readObject(); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
out.writeObject(element); 

I 

doss ShortSeriolizer implements SeriolizerlF \ 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
short value = in.readShort(); 

return new Short(value); 

FIG. 1 1 0E 
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public void writeObject(Ob]ectOutput out, Object element) throws lOException | 
out.writeShort(((Short)element).shortValue()); 



class SimpleTimeZoneSericlizer implements SeriolizerlF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException, lOException | 
int offset = in.reodlntQ; 

SeriolizerlF seriolizer = BaseSerializer.getlnstanceO; 
String id = (String)serializer.readObject(in); 

return new SimpleTimeZone(offset. id); 

i 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writelnt(temp.getRawOffset()); 

SeriolizerlF seriolizer = BoseSeriolizer,getInstonce(); 

seriolizer.writeObject(out, temp.getID()); 



doss StringSerioiizer implements SeriolizerlF { 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException | 
int size = in.reodShortQ; 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

return new String(bytes); 

public void writeObjectfObjectOutput out, Object element) throws lOException | 
byte[] bytes = ((String)element).getBytes(); 

out.writeShort(bytes.length); 
out.write(bytes); 



class VectorSeriolizer implements SeriolizerlF j 

* public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException { 
int size = in.reodShortQ; 

Vector vector = new Vector(size); 
for (int i = 0; i < size; i++) \ 

SeriolizerlF seriolizer = BoseSeriolizer.getlnstonce(); 

vector.addElement(seriolizer.readObject(in)); 

FIG. 1 1 0F 
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return vector; 

public void writeObject(ObjectOutput out, Object element) throws lOException 
Vector temp = (Vector)element; 

Object[] orroy = new Object[temp.size()]; 
for (int i = 0; i < orroy.length; i++) | 
array[i] = temp.elementAt(i); 

out.writeShort(QrrQy.length); 

for (int i = 0; i < orray.length; i++) \ 

SerializerIF seriolizer=BaseSerializer.getlnstance(); 

seriolizer.writeObject(out, orroy[i]); 



A* 

* Defoult constructor. The constructor is private because this is a 

* singleton doss. When the object is constructed, it initializes its 

* tobies. 

V 

private BaseSerializer() | 
^ initO; 

/** 

* Adds the given elements to the three tables. 
* 

* ©porom classNome the name of the class 

* ©porom code the code for the given class 

* ©porom seriolizer the object responsible for serializing the given 

* class 

V 

private void oddDataToTobles(String clossNome, Number code, SerializerIF seriolizer) | 
getCodeTable().put(code, classNome); 
getNameTable().put(clossName, code); 

if (seriolizer != null) j 

getSeriolizerTable().put(code, seriolizer); 



FIG. 1 1 0G 
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A* 

* Creoles the codes ond seriolizer objects for the defoult seriolizotion 

* dosses ond odds them to the tobies. The tobies ore then written to 

* 0 seriolized file. 

*/ 

privote void creoteDefoultToblesO | 

oddDotoToTobles(BigDecimol.closs.getNonne(), new Byte((byte)l), new 
BigDecimolSeriolizerO); 

QddDatoToTables(Biglnteger.class.getNomeQ, new Byte((byte)2), new BigintegerSerializerQ); 

oddDotoToToblesfBooleon.closs.getNonneO, new Bvte((byte)3), new BooleonSeriolizer()); 

oddDatoToTobles(Byte.closs.getNome(), new Byte((byte)4), new ByteSeriolizer()); 

oddDotoToTobles(Chorocter.closs.getNome(), new Byte((byte)5), new ChorocterSeriolizer()); 

oddDotoToToblesfDote.closs.getNomeO, new Byte((byte)6l. new DoteSeriolizerQ); 

oddDotoToToblesiDoubie.class.getNonneO, new Byte((byte)7). new DoubleSeriolizer()); 

oddDatoToTobiesfFloot.closs.getNonneO. new Byte((byte)8), new FlootSerializer()); 

oddDotoToTobles(GreqorionColendor.closs.getNonneO. new Byte((byte)9). new 
GregorionColendorSeriolizerQ; 

oddDotoToToblesflnteger.cioss.getNonneO, new Byte((byte)10), new IntegerSerializer()); 

oddDotoToToblesiLong.closs.getNomeQ, new Byte((byte)1 1), new LongSeriolizer()); 

oddDotoToTobiesiShort.closs.getNomeQ, new Byte((byte)12), new ShortSerializer()); 

oddDotoToTobles(SinnpleTinneZone.closs.getNonne(). new Byte((byte)13), new 
SinnpleTimeZoneSeriolizerO); 

oddDotoToToblesfString.closs.getNomeQ, new Byte((byte)14). new StringSerializer()); 

oddDotoToToblesfVector.closs.getNomeQ, new ByteffbytellS^ new VectorSeriolizerQ); 

oddDotoToTobles(Object.closs,getNonne(), new Byte((byte)16). new ObjectSeriolizerQ); 

writeTobles(); 

A* 

» Returns on instonce of the toble of doss nomes, keyed by their code. 

* If the toble does not exist, it is created. 
» 

* ©return The table of doss names. 
»/ 

protected Hoshtobie getCodeTableQ \ 
if (codeToble == null) | 

codeToble = new Hoshtoble(); 

' FIG. 11 OH 
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return codeToble; 

» Returns on instance of <code>BoseSeriolizer</code>. 

* ©return An instonce of <code>BQseSeriQlizer</code>. 

public static SeriolizerIF getlnstonceQ | 
if (instance == null) | 

instance = new BaseSeriaiizerQ; 

return instance; 

K. 

* Returns on instance of the table of codes, keyed by their 

* corresponding doss nome. 

* If the table does not exist, it is created. 
♦ 

* ©return The table of codes. 

V 

protected Hoshtoble getNameTable() j 
if (nameTable == null) | 

nonneTable = new HoshtobleQ; 

I 

return nameTable; 

* Returns on instance of the table of seriolizers, keyed by their 

* corresponding code. 

* If the table does not exist, it is created. 

* . 

* © return The table of class names. 

•/ 

protected Hoshtoble getSerializerTable() | 
if (serializerToble == null) | 

seriolizerToble = new Hashtable(); 

I 

return seriolizerToble; 

* Initializes the hoshtoble from either a serialized hoshtoble or from 

* an ini file. 

*/ 

FIG. 1 1 01 
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protected void init() | 

File seriolizedFile = new File(HASHTABLE_SER); 
File iniFile = new File(INLFILE); 

if (serializedFile.existsO) { 

reodSeriolizedFile(seriolizedFile); 

I else } 

if (iniFile.existsO) \ 

reodlniFile(iniFile); 

creoteDefoultToblesO; 



A* 

* Gets the value of the seriolizotion code fronn the toble bosed on 

* the classNonne provided. The value returned con either be a 

* <code>Byte</code> or on <code>lnteger</code>. The return value 

* will be 0 <code>Byte</code> if the clossNonne is one of the bose 

* data types. 
* 

* ©return The seriolizotion code of the clossNonne. 

* ©porom clossNome the nonne of the doss 

V 

private Nunnber lookupCode(String clossNonne) | 
Nunnber code = null; 

if (clossNonne != null) | 

code = (Nunnber)getNonneTable(),get(clossNanne); 

return code; 



* Looks up the hoshcode in the table and returns the String value of 

* the hoshcode. If the hoshcode does not exist in the toble 

* <code>null</code> is returned. 
* 

* ©return The object that was stored in the table with the given 

* hoshcode. 

* ©poronn hoshcode the hoshcode that will be used to look up the value 

FIG. 11 OJ 
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private String lookupNome(Number code) | 
String clossNonne = null; 

if (code != null) j 

clossNonne = (String)getCodeToble().get(code); 

return clossNonne; 

* Default nnethod connment. 
♦ 

* <P>PRE: 

* <P>POST: 

* 

* ©return Poronneter not modified 

* ©return com.ibnn.jtc.util.SeriolizerIF 

* ©poronn code int 

*/ 

private SeriolizerlF lookupSerializer(Number code) | 
SeriolizerIF seriolizer = null; 

if (code != null) | 

seriolizer = (SeriolizerIF)getSerializerTable(),get(code); 

return seriolizer; 

* Default method comment. 
« 

* <P>PRE: 

* <P>POST: 

* 

* ©return Poronneter not modified 

* ©porom iniFile jovo.io.File 

V 

private void reodIniFile(File iniFile) | 
BufferedReoder in = null; 

try I 

in = new BufferedReoder(new FileReoder(iniFile)); 

for (String inline = in.reodLine(); inline 1= null; inline = in.reodline()) \ 
String trimline = inline.trim(); 

FIG. 1 1 0K 
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if ((trimLine.lengthO > 0) && 

ItrimLine.stortsWithC'f')) | ' - 

StringTokenizer tokenizer = new StringTokenizer(trimLine); 

String clossNonne = tokenizer.nextToken(); 

Integer code = new lnteger(c!QSsNome.hashCode()); 

SeriolizerlF seriolizer = null; 

if (tokenizer.hosMoreTokensO) | 

String serializerNome = tokenizer.nextTokenQ; 

try { 

seriolizer = {SerializerlF)Closs.forNome(serializerNome).newlnslance(); 
} catch(Exception e) | | 

oddDotoToTobles(classNanne, code, seriolizer); 

I cotch fException throwAwcy) j 
I finolly ; 
try I 

in.closeQ; 
I catch (Exception throwAwoy) { 

I 

writeTobles(); 

A' 

* Reods the object fronn the streom by first reoding the code for the 

* element then reods the oppropriote doto for thot object. 
♦ 

* ©return The object thot was read from the stream. 

* ©porom in the input stream that contains the object 

V 

public Object readObject(Objectlnput in) 

throws ClossNotFoundException, lOException \ 
Object retVal = null; 
Number code = null; 

byte boseCode = in.readByte(); 

FIG. 11 OL 
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if (baseCode == NULLOBJECT) | 
retVol = null; 

if (baseCode != OTHER) | * . 

code = new Byte(boseCode); 

{ else I 

int secondCode = in.reodlnt(): 
code = new Integer(secondCode); 

SeriolizerlF seriolizer = lookupSerializer(code); 
if (seriolizer != null) | 

retVol = serializer.readObject(in); 

I else I 

String clossNonae = lookupNGnne(code); 
try } 

retVol = Closs.forNanae(clossNonne).newlnstonce(); 

if (retVol instonceof Externolizoble) | 

((Externolizoble)retVol),reodExternQl(in); 

I else j 

retVol = in.reodObject(); 
I cotch(Exception e) \ 

return retVol; 

♦ Reods the file contoining the seriolized hoshtobles of doto. 

* @porom seriolizedFile the file contoining the seriolized tobies 

*/ 

privote void readSeriolizedFile(File seriolizedFile) { 
ObjectlnputStreom in = null; 
try I 

in = new ObjectlnputStreonn(new FilelnputStreom(seriolizedFile)); 
codeToble = (Hoshtable)in.reodObject(); 
nonneToble = (Hoshtoble)in.readObject(); 
seriolizerToble = (Hashtoble)in.reodObject(); 

FIG. 1 1 0M 
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i catch fException throwAway) | 
\ finally | 

try { 

in.close(); 
} cotch (Exception throwAway) | ( 

if ((codeTobie =- null) || 

nameTable == null) || 
seriolizerToble == null)) | 

creoteDefouitTablesO; 



* Writes the given object to the streom. First, the code representing 

* the type of the object is written, then the data within the object 

* is written. 
* 

* ©porom out the output stream thot will contain the object 

* ©parom elennent the data object that will be written 
»/ 

public void writeObject(ObjectOutput out. Object element) 
throws iOException | 

if (element == null) | 

out.writeByte(NULLOBJECT); 

I else I 

String clossName = element.getClass().getName(); 
Number code = lookupCode(className); 

if (code != null) | 

if (code instanceof Byte) | 

out.writeByte(code.byteValue()); 
\ else if (code instonceof Integer) | 

out.writeByte(OTHER); 

out.writelnt(code.intValue()); 

SeriolizerlF seriolizer = lookupSeriali2er(code); 

if (seriolizer != null) | 

seriolizer.writeObject(out, element); 
I else if (element instonceof Externolizoble) { 

((Externalizable)element).writeExternal(out); 

FIG. 1 1 0N 
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\ else \ 

out.writeObject(element); 

I else I 

if (element instonceof Objectrj) | 

ciossName = Object[].class.getNome(); 

I else I 

ciossName = Object.ciass.getNameQ; 

code = lookupCode(clossNome); 

SeriolizerIF serioiizer = lool<upSeriolizer(cocle); 

out.writeByte(code.byteValue()); 
seriQlizer.writeObject(out, element); 



* Writes the tobies to the file. 

*/ 

privote void writeTobies() | 

ObjectOutputStreom out = null; 



try I 



File serFile = new File(HASHTABLE_SER); 

out = new ObjectOutputStreom(new FileOutputStream(serFile)); 



out.writeObjectfgetCodeTobleO); 

out.writeObjectfgetNomeTableO); 

out.writeObject(getSeriolizerToble()); 

out.writeObject(new Date()); 
I cotch(Exception e) | 
I finolly I 

try I 

out.close(); 
} cotch(Exception e) | \ 
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pockoge com.ibm.jtcx.seriolizotion; 



imporl 
impor 
impor 
imporl 
imporl 
imporl 
imporl 
imporl 
imporl 
imporl 

/ 



ova. 10.*; 

ovo.moth.Biglnteger; 
ova. moth. BigDecimol; 
iovo.util.Dote; 

iavo.util.GregorianCalendar; 

iovo.util.Hoshtable; 

iava.util.SimpleTimeZone; 

iovo.util.StringTokenizer; 

ova.utilJimeZone; 

ovo.util.Vector; 



The <code>SenalizerIF</code> that is used as the base level 
seriolizer. It contains three tables used to serialize objects: 
<br><ul> 

<li> codeTobie: the table contoining the serioiizotion code of 

on object based on the name of the class 
<li> nomeTobie: the table contoining the nome of the class 

based on the serialization code 
<li> serializotionTable: the table containing the seriolizer of 
on object based on its serialization code 

</ul> 
<br><br> 

<code>BaseSerializer</code> delegates the responsibility of 
seriolizing the objects to the <code>SerializerlF</code> associated 
with that class or to the object itself if it implements 
<code>Externalizable</code>. 

public class BoseSeriolizer implements SeriolizerlF | 
static private final int NULL^OBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "CiassNomeHosh.ser"; 
static privote final String INLFILE = "ClossNames.ini"; 

stotic private Hashtoble codeTobie = null; 

static private Hashtoble nomeTobie = null; 

static private Hoshtoble seriolizerTobie = null; 

static private BoseSeriolizer instance = null; 

doss BigDecimolSerializer implements Seriolizer IF | 

public Object readObject{Objectlnput in) throws ClossNolFoundException, lOException 
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pockoge com.ibm.jtcx.seriolizotion; 

import jovo.io.IOException; 
import jova.io.Objectlnput; 
import jovG.io.ObjectOutput; 
A* 

» The interface for those classes that serialize objects to and from 

* a stream. The object that implements this interface should write 

* just the object's ottributes, not any other descriptive information 

* about the object. Typically, a <code>SerializerlF</code> knows how * 

* to serialize a specific class. 

public interface SerioiizerlF j 
A* 

* Reads on object from the stream, 
* 

* ©return The object that was read. 

* ©porom in the input stream containing the object 

* ©exception jovo.io.lOException thrown if the stream foils 

* ©exception jovo.Iang.ClossNotFoundException thrown if the stream 

* fails 

V 

Object readObject(Object Input in) throws lOException, ClossNotFoundException 
A* 

* Writes the given object to the stream. 

* ©porom out the output stream into which the object will be written 

* ©porom element the object that will be written to the stream 

* ©exception jovo.io.lOException thrown if the stream foils 
*/ 

void writeObject(ObjectOutput out, Object element) throws lOException; 
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